Handling Update Events1

QuickTime 2.1 introduced a new function, InvalidateMovieRegion, to use in place of the UpdateMovie function to indicate the area of a movie that needs to be redrawn.

InvalidateMovieRegion

Use the new InvalidateMovieRegion function instead of the UpdateMovie function to invalidate a small area of a movie. InvalidateMovieRegion marks all areas of the movie that intersect the invalidRgn parameter. The next time you call the MoviesTask function, the toolbox redraws the marked areas.



 
pascal OSErr InvalidateMovieRegion (

                     Movie theMovie, 

                     RgnHandle invalidRgn);

theMovie: Identifies the movie whose area you wish to invalidate. Your application obtains this movie identifier from such functions as NewMovie , NewMovieFromFile , and NewMovieFromHandle .
invalidRgn: Contains a region indicating the area of the movie to invalidate. If necessary, QuickTime will make a copy of this region. To invalidate the entire movie area, pass nil for this parameter.

Description

The InvalidateMovieRegion function provides a way to invalidate a portion of the movie's area instead of its entire area, as does UpdateMovie . This allows for higher performance update handling when a movie has many tracks or covers a large area. For handling of update events, applications should continue to use UpdateMovie .

RESULT CODES

invalidMovie -2010 The movie is corrupted or invalid